home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Libris Britannia 4
/
science library(b).zip
/
science library(b)
/
UTILITIE
/
CPU_MEMO
/
1648.ZIP
/
TESS-D.ARC
/
VER110.DOC
< prev
Wrap
Text File
|
1988-10-02
|
9KB
|
442 lines
TesSeRact(TM)
A Library of Routines for Developing Ram-Resident Programs
and
A Proposed Standard for Ram-Resident Program Communication
Documentation Update for Version 1.10
October 2, 1988
Copyright (c) 1988, TesSeRact Development Team
All Rights Reserved
_______
____|__ | (TM)
--| | |-------------------
| ____|__ | Association of
| | |_| Shareware
|__| o | Professionals
-----| | |---------------------
|___|___| MEMBER
Table of Contents
Chapter 1. Introduction........................................2
Order Form.................................................3
Chapter 2. New TesSeRact Library Routine.......................4
TsRestore2F................................................4
Chapter 3. New TesSeRact Multiplex Functions...................5
TSR Utility Routines.......................................5
Trigger PopUp (Function 22h)..........................5
Trigger Background (Function 23h).....................6
Chapter 4. Changes to TesSeRact................................7
-1-
Chapter 1. Introduction
This file contains necessary update information for Version 1.10 of the
TesSeRact Library. Two new Interrupt 2Fh Multiplex Functions have been
added, and one additional TesSeRact Library routine has also been added.
In addition, this document also contains a listing of all bugs/problems
repaired since Version 1.00 of the library.
Finally, please note our new address:
TesSeRact Development Team
1657 The Fairways
Suite 101
Jenkintown, PA 19046
Phone: 215-884-3373
CIS: 70731,20
MCI: 315-5415
FAX: 215-886-4225
-2-
TesSeRact(TM) Products Order And Registration Form
Registration Number: ____________________________
Name: ______________________________________
Address: ______________________________________
______________________________________
City: ______________________________________
State: __________________________ Zip: ______
Telephone: ______________________________________
Item Quantity Total
--------------------------------------------------------------
Registered User Upgrade ($10)_______________________|_________
(to Version 1.10)
Upgrade for Registrations after 9/15/88_____________|____0.00_
TesSeRact Registration ($25 each)___________________|_________
TesSeRact Source Code License ($25 each)____________|_________
TesSeRact Trial Disk ($10)__________________________|_________
Monthly Information NewsLetter______________________|_________
($10 per year)
Product Identification String (Free!!)______________|____0.00_
Your ID String: ______________ Product Name: ______________
Shipping Charges: Upgrade Order Normal Registration
U.S. : $ 0.00 U.S. : $ 0.00
Canada: $ 5.00 Canada: $10.00
Europe: $10.00 Europe: $15.00
Overnight: $15.00 + Normal Shipping Charge (from above)
Total Shipping Charges______________________________|_________
--------------------------------------------------------------
Total Due: |_________
Preferred Disk Size: 3.5" ____ 5.25" ____
Where did you hear about TesSeRact? __________________________
Primary Language/Compiler: ___________________________________
Mail Completed Form to:
TesSeRact Development Team
1657 The Fairways
Suite 101
Jenkintown, PA 19046
-3-
Chapter 2. New TesSeRact Library Routine
TsRestore2F -- Restore Interrupt 2Fh to original state
This function should be called by any program that calls
TsCheckResident() and DOES NOT REMAIN RESIDENT. Call this function
BEFORE EXITING THE PROGRAM to ensure that the Interrupt 2Fh handler
is set to its original default value of 00 00, if necessary. It is
not necessary to call this routine if your program calls
TsDoInit(), or if your program does not call the TsCheckResident()
library routine.
Parameters:
None.
Returns:
None.
C Language Usage:
extern void far TsRestore2F(void);
Pascal Usage:
procedure TsRestore2F;
Assembler Usage:
EXTRN TSRESTORE2F:NEAR
call TSRESTORE2F
;
; NOTE: AX, BX and ES registers destroyed
;
-4-
Chapter 3. New TesSeRact Multiplex Functions
TSR Utility Routines
Trigger PopUp (Function 22h)
This function hass been added to permit an application to 'trigger' a
POPUP procedure. When this call is completed, the TSR will pop up
at the earliest opportunity, just as if the TsrStatus flags had
been manipulated directly. TsrMain() will be called (if it is
save) as soon as possible, or a TsrBeep() procedure will be called
to signal the TSR is unable to popup.
Parameters:
TsrIdNum.................Identification Number of TSR to call
Returns:
Non-Zero -- Unable to pass pointer -- invalid ID Number
Zero -- Success
C Language Usage:
extern unsigned far pascal TsTriggerPop(
unsigned short TsrIdNum
);
Pascal Usage:
function TsTriggerPop(
TsrIdNum : word
) : word;
Assembler Usage:
mov ax,5453h
mov bx,22h
mov cx,TsrIdNum
int 2fh
;
; result returned in AX
;
-5-
Trigger Background (Function 23h)
This function allows a program to directly call the background
procedures if it is safe for the background procedure to be called.
PLEASE USE CAUTION WHEN CALLING THIS FUNCTION!! It will allow a
background procedure to be called when INDOS is set to 1. The
purpose of this function is to allow network programs to
independently signal an idle status.
Parameters:
TsrIdNum.................Identification Number of TSR to call
Returns:
Non-Zero -- Unable to pass pointer -- invalid ID Number
FFFFh -- Not safe to call Background procedure
Zero -- Success
C Language Usage:
extern unsigned far pascal TsTriggerBack(
unsigned short TsrIdNum
);
Pascal Usage:
function TsTriggerBack(
TsrIdNum : word
) : word;
Assembler Usage:
mov ax,5453h
mov bx,23h
mov cx,TsrIdNum
int 2fh
;
; result returned in AX
;
-6-
Chapter 4. Changes to TesSeRact
Critical Error Flag pointer now works correctly under OS/2 1.0.
Add check for DOS 4.0.
TsSetAdrTP4 now returns with the correct RET instruction.
TempParms data area reduced to correct size.
INT 21h 'gate' array must fall on EVEN boundary in Turbo Pascal versions.
Check to make sure stacks are set on EVEN boundaries.
Modified TESSDEMO to work better with MSC.
Added Turbo Pascal 5.0 source/unit.
Move EXTRN for user procedures outside simplified CODE statement so they
can be called in large-model programs.
Change code for INT 16h, Fn 0 to get around XTREE bug that checks the FLAGS
register.
Force DOS to use AUXSTACK on INT 21h, Fn 0-12 if popped up from DOS command
line. 'C' programmers can now use getch().
Added TsTriggerPop and TsTriggerBack.
Added internal function _TESSBACKGROUND to check if safe to call background
procedure.
Added TsRestore2F() function; call this internally before releasing TSR!!
Fixed problem with popping up over INT 8
-7-